Microsoft Insider spills beans on Windows jitter. 
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Windows 


Eliminating Jitter 


Do your applications suffer from jitters? Microsoft’s David Thielen 
explains how to keep Windows programs smooth and professional. 


In many cases, making a program better 
means making it less obtrusive to the user. 
Eliminating screen jitter is one small way to 
make a program less obtrusive. 


To paint in Windows, a program usually 
takes two steps: it erases the invalid region 
on the screen, and then paints the updated 
region, Jitter is the visible delay between 
the erase and the paint, the pause after the 
screen is cleared and before it is redrawn. 
You can eliminate it from your program in 
either of two ways. 


The Best Way 


A screen erase takes time, and completely 
avoiding it saves that time. When it is easy 
and efficient to do so, you can draw every 
invalid pixel, thereby eliminating the need 
to erase the invalid region before painting. 
For example: when drawing text, at the end 
of each line of text, fill the rest of the line 
with the background colour (rather than 
the jitterful approach: blank the whole lot 
and start again). 


The Other Way 


If you can't easily or efficiently draw every 
invalid pixel, you can tackle jitter in another 
way. Instead of drawing on the screen, 
draw ona bitmap, and then ‘blt’ the bitmap 


to the screen. (‘Bit’ is not an acronym for 
Bacon, Lettuce and Tomato, but the first of 


an exciting new range of NT-compatible 
vowel-less verbs which .EXE will be promot- 
ing during 1993. It means ‘blit’ - Ed.) 


The procedure is as follows. We create a 
bitmap, and initialise it by erasing it with the 
background brush. We then perform all 
painting to the bitmap instead of the screen. 
Once the bitmap is an image of the updated 
region, itcan be blt’ed to the video memory. 
Each pixel will change from its old value to 
its new value. Pixels that don't change will 
not first be erased - the user will see only 
the changes on the screen, no jitter. 
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Before, the program might have erased a 
line of text and then redrawn it with a new 
letter at the end. Now the user sees only the 
new letter appear at the end - even though 
the program is redrawing the entire line. If 
the line is shifting due to word-wrapping, 
the user will just see the line shift. The line 
won't disappear and then be redrawn, This 
makes the program appear significantly 
better and more professional to most users. 


When Not to Try It 


f the solution is so simple, why didn’t 
Microsoft implement it in Windows? There 
were three very good reasons. 


First, a bitmap takes up memory, This 
doesn’t matter much in a machine which 
has a 256 KB VGA card and 4 MB of system 
RAM, but the memory requirement would 
have been catastrophic on the average 8086 
using Windows 1.0, Even in 386 mode, the 
extra memory usage can have a noticeable 
effect on performance if the size of a sys- 
tem’s video RAM is close to that of the 
system RAM. A video card with 2 MB of 
RAM ona system with 2 MB of RAM would 
be slow. 


Second, the user who draws on a bitmap 
(rather than on the screen) can’t use the 
capabilities of video processors to speed up 
drawing. Video cards with processors im- 
prove speed of drawing significantly. A 
user is generally unwilling to sacrifice fast 
response to eliminate screen jitter. 


Third, using this method, the screen will not 
change until all drawing on the bitmap is 
complete. If your CAD program takes 15 
seconds to draw a complicated image, you 
want the user to know the program is work- 
ing. Many users would rather see the lines 
being drawn rather than see nothing until 
the completed drawing flashes up. Also, the 
user sees the program working and gets an 
idea of the pace at which the task will be 
completed, You probably should not use 
an intermediate bitmap if drawing is going 
to take more than half a second. 


In most programs, you will probably want 
to use this ‘bitmap method’ judiciously. It 
makes the most sense to use it when your 
program repeatedly redraws what is al- 
ready on the screen. You can also give the 
user the option of choosing which drawing 
method to use, 


The Basic Concepts 


I designed the Paint Begin and Pain- 
tEnd functions (contained in PAINT.C, 
see Figure 2) to work much as Begin- 
Paint and EndPaint do. Paint- 
Begin returns a device context that you 
can nearly always treat the same as the 
device context returned from Begin- 
Paint. (I discuss exceptions later in this 
article.) This means you can replace ‘Be- 
ginPaint’ with ‘PaintBegin’, and 
‘EndPaint’ with ‘PaintEnd’ in your 
existing code and, with no other changes, 
eliminate jitters from your program. 


typedef struct S PAINTBLT 
{ 


int iXxorg; // 
int iYorg; // 
POINT pSize; // 
HWND hWnd; // The 
HDC hDe; // The 
HBITMAP hBm; // The 
RECT Rect; // The 
PAINTSTRUCT sPs; // The 


} PAINTBLT; 


The ViewOrg of the window 
before we change it 

Pixel size of bitmap 
window 
bitmap DC we create 
bitmap we create 
invalid rectangle 

sPs set by BeginPaint 


(used by PaintEnd) 


Figure 1 - The PAINTBLT struct 
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Windows 


#include "windows.h" 
finclude "paint.h" 


// Call this function instead of BeginPaint 
HDC PaintBegin (HWND hWnd, PAINTBLT *pPb) 
{ 

DWORD dw; 

HDC hDc, hDcBm; 

HBRUSH hBr; 


// Otherwise, while we will paint the entire 
// rectangle to the bitmap, we will only blt 
// the region - which is slower. 
GetUpdateRect (hWnd, &(pPb->Rect), FALSE); 
InvalidateRect (hWnd, &(pPb->Rect), FA\ 
pPb->pSize.x = pPb->Rect right - 
pPb->Rect . left; 


// We want to invalidate the entire rectangle 


// Call instead of EndPaint 
void PaintEnd (PAINTBLT *pPb) 
{ 
BITMAP bm; 
// Set back to text mode (in case changed). 
// Set the viewport org back 
// to match the window 
SetMapMode (pPb->sPs.hdc, MM_TEXT); 
SetViewportOrg (pPb->sPs.hdc, pPb->iXorg, pPb->iYorg); 
SetMapMode (pPb->hDc, MM_TEXT); 
SetViewportOrg (pPb->hDc, pPb->iXorg, pPb->iYorg); 
// Copy the bitmap to the window 
BitBlt (pPb->sPs.hdce 
pPb->Rect .left, pPb->Rect top. 
pPb->pSize.x, pPb->pSize.y, 
pPb->hDec, 0, 0, SRCCOPY); 


pPb->pSize.y = pPb->Rect .bottom — 
pPb->Rect..top; 

hDe = BeginPaint (hWnd, & (pPb->sPs)) 

// Create a DC with a bitmap 

// to match the invalid screen rect 

hDcBm = CreateCompatibleDC (hDc) ; 

pPb->hBm = CreateCompatibleBitmap (hDc. 


SelectObject (hDcBm, pPb->hBm) 
// Set the viewport origin so it acts 
// JUST like the window DC 
dw = GetViewportorg (hDcBm); 
pPb->ixorg = LOWORD (dw); 
PpPb->iYorg = HIWORD (dw); 
SetViewportOrg (hDcBm, 
pPb->iXorg ~ pPb->Rect. left, 
pPb->iYorg - pPb->Rect.top) ; 
// If this flag is set, we need to first 
// init the bitmap to the background 
// brush. 
if (pPb->sP 
if ((hBr 
(HBRUSH) GetClassWord (hind 
GCW_HBRBACKGROUND) ) != 


NULL) 
{ 
UnrealizeObject. (hBr); 
SetBrushOrg (hDcBm, 
(pPb->iXorg - pPb->Rect.left) & 7, 


FillRect (hDcBm, &(pPb->Rect), hBr); 
) 


// Save hWnd & hDcBm for PaintEnd 

pPb->hiind = hWnd 

return (pPb->hDe = 
) 


hDcBm) ; 


pPb->pSize.x, pPb->pSize.y); 


get the brush aligned! 


(pPb->iYorg - pPb->Rect.top) & 7); 


DeleteDC (pPb->hDe) ; 


) 
DWORD PaintSetViewOrg 


{ 
DWORD dw; 


return 


{ 
DWORD dw; 


return 


HDC PaintGetDe (PAINTBLT 
{ 

return (pPb->sPs.hde) ; 
) 


// We're done ~ clean up 


DeleteObject (pPb->hBm) ; 
EndPaint (pPb->hWnd, &(pPb->sPs)); 


// Call instead of SetViewportorg 
(PAINTBLT *pPb, int ixorg, int iYorg 
// Set to the new value 
dw = SetViewportOrg (pPb->hDe 
iXorg - pPb->Rect.left, 
iYorg - pPb->Rect.top); 
// Return the corrected old value 
(MAKELONG (LOWORD (dw) + pPb->Rect.left 


HIWORD (dw) + pPb->Rect.top)); 


// Call instead of GetViewp: 
DWORD PaintGetViewOrg (PAIN! 


dw = GetViewportOrg (pPb->hDc) + 
// Return the corrected value 


(MAKELONG (LOWORD (dw) + pPb->Rect. left 
HIWORD (dw) + pPb->Rect .top)) 


// Call to get the actual client area DC 


*pPb) 


This simple replacement is critical for two 
reasons. First, it would generally be a lot of 
work to rewrite existing code to use these 
calls. It would also require learning how to 
paint using both the standard Windows 
method and the bitmap method. Second, a 
nearly identical device context makes it is 
easy to write code that can switch between 
both methods as appropriate. 


PAINT. 


PaintBegin needs to determine the 
value of a number of variables which are 
saved and then passed back to Pain- 
tEnd. These values are all in the struct 
PAINTBLT, given in Figure 1. You should 
treat all the values in PAINTBLT as pri- 
vate. You must declare the struct publicly, 
because the calling application needs to 
use it for local variables, and to pass it to the 
calls. However, you should not access any 
of the structure elements directly outside 
PAINT.C (shown in Figure 2). 


PaintBegin 
When we first receive a WM_PAINT mess- 
age, the invalid region of the window still 


Figure 2 - PAINT.C 


exists, When we call BeginPaint, we 
mark the window as valid and copy the 
region to the PAINTBLT struct. 


This tactic needs a little explaining. It is 
usually quicker to determine the invalid 
region, and draw only within it, than to 
redraw the entire invalid rectangle. The 
invalid rectangle is the smallest rectangle 
containing the invalid region, but parts of 
the rectangle are usually valid and therefore 
are not redrawn. However, we can create 
only rectangular bitmaps. And when we 
draw ona bitmap, we cannot draw only in 
the invalid regions. So the invalid region 
would only be used to determine the parts 
of the bitmap to blt when we are done. 


Ablt toa rectangular area is generally quite 
fast. Bling to the invalid region is gener- 
ally slower than just blt’ing the entire rec- 
tangle, Therefore, we want to force the 
entireinvalid rectangle to be invalid before 
calling BeginPaint, so the entire rec- 
tangle will be repainted. 
GetUpdateRect (hWnd, 
& (pPb->Rect) , 


InvalidateRect (hWnd, 
& (pPb->Rect) , 


FALSE) ; 


FALSE) ; 


hDe = BeginPaint (hWnd, 


& (pPb->sPs)); 


To geta Device Context, we call Create- 
CompatibleDC, CreateCompati- 
b1leDC will returna device context that has 
the same values as the screen device con- 
text, However, this returned device context 
has no memory associated with it; it merely 
matches the screen device context in terms 
of its parameters. It's as though we pulled 
the video memory out of its sockets - the 
screen device context would still be the 
same, but there would be no memory to 
access. 


We then create a bitmap and assign the 
bitmap to the compatible device context. 
This gives the compatible device context 
memory to draw in. However, to reduce 
memory consumption, we do not create a 
bitmap the size of the screen. Instead, we 
create a bitmap the size of the invalid rec- 
tangle. This saves a lot of memory, but it 
also introduces some slight incompati- 
bilities between the two device contexts 
(more on this later). 


pPb->pSize.x = pPb->Rect.right 
- pPb->Rect.left; 
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pPb->pSize.y = pPb->Rect.bottom 
- pPb->Rect.top; 

hDcBm = 

CreateCompatibleDC (hDc) ; 

pPb->hBm — 

CreateCompatibleBitmap (hDc, 

pPb->pSize.x, pPb->pSize.y); 

SelectObject (hDcBm, pPb->hBm) ; 


Next, we adjust the viewport origin of the 
compatible device context so that it mat- 
ches its location in the screen device con- 
text. This adjustment allows the 
compatible device context to appear the 
same as the actual screen device context. 
Any drawing calls to the device context 
can pass in the (X, Y) codrdinates that 
they previously passed in to the screen 
device context. 


dw = GetViewportOrg (hDcBm) ; 
pPb->ixXorg = LOWORD (dw); 
pPb->iYorg = HIWORD (dw); 
SetViewportOrg (hDcBm, 
pPb->iXorg - pPb->Rect.left, 
pPb->iYorg - pPb->Rect.top); 


Finally, if the bitmap needs to be erased, we 
fill it with the window class background 
brush. This initialises the bitmap contents 
to an erased window. As with the viewport 
origin, we have to set the brush origin cor- 
rectly so that the brush lines up. To do this, 
we determine the number of pixels from 
the window’s upper left corner to the be- 
ginning of the bitmap. We then set the 
origin of the brush to this value. 


if (pPb->sPs.fErase) 
if ((hBr = 
(HBRUSH) GetClassWord 
(hWnd, GCW_HBRBACKGROUND) ) 
!= NULL) 
{ 
UnrealizeObject (hBr); 
SetBrushOrg (hDcBm, 
(pPb->ixXorg - 
pPb->Rect.left) & 7, 
(pPb->iYorg - 
pPb->Rect.top) & 7); 
FillRect (hDcBm, 
&(pPb->Rect), hBr); 
} 


The Application 


At this point, the application can use the 
returned device context to draw the screen. 
It does so in exactly the same manner as the 
device context returned by Begin- 
Paint. 


Itis important that the WM_ERASEBKGND 
handler returns 0. If — the 
WM_ERASEBKGND message is passed to 
DefWindowProc, then the screen will 
be erased and the jitters will remain. If the 
WM_ERASEBKGND returns a non-zero 
value, sPs.fErase will be 0, and 
PaintBegin will not erase the bitmap. 
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Windows 


HDC hDc; 
PAINTBLT sPb; 


case WM_ERASEBKGND : 
return (0); 


case WM_PAINT : 


hDe = PaintBegin (hWnd, &sPb); 


PaintEnd (&sPb); 
break; 


// 0 means it is NOT erased!!! 


// Message: paint the window 


// Blt the DC to the screen 


// Get the DC 


Figure 3 - Application’s message handling 


Aside from these two differences, every- 
thing else in the application should be just 
as it was when using BeginPaint and End- 
Paint. Figure 3 shows the relevant frag- 
ments from the application’s message 
handling component. 


PaintEnd 


Once the application has completed draw- 
ing to the bitmap DC, we need to copy the 
bitmap to the screen. Tirst, we must resct 
the mapping modes of both device con- 
texts. If the mapping modes or viewport 
origins have changed and we don’t reset 
them, we will blt the bitmap to the wrong 
location on the screen, 


The following code assumes that the original 
device context was in text mode when it was 
returned by BeginPaint. This is true un- 
less the window or class has its own device 
context. If you are using a window with a 
private device context, you might need to 
change this to save the original mapping 
mode and restore it after the bitmap is blt'd. 


SetMapMode (pPb->sPs.hdc, 
MM_TEXT) ; 
SetViewportOrg (pPb->sPs.hdc, 
pPb->iXorg, pPb->iYorg) ; 
SetMapMode (pPb->hDc, MM TEXT); 
SetViewportOrg (pPb->hDc, 
pPb->iXorg, pPb->iYorg); 


Once both device contexts are in the proper 
mode, we need to blt the bitmap to the 
screen, When this happens, the user will 
see the screen change. Microsoft has 
worked diligently to make the blt fast. 
Generally, you will not see the blt - but 
occasionally, especially if some of the bit- 
map is swapped to disk (virtual memory), 
you will see the blt sweep down the screen. 


A possible enhancement to this function is to 
have the byte boundaries of the bitmap and 
the screen match. It might even be faster if we 
expand the invalid rectangle to the left and 
right to put the invalid rectangle itself on a 
byte boundary. Unfortunately, we have no 


guarantee that the video memory actually 

begins each line of pixels on a byte bound- 

ary. 

BitBlt (pPb->sPs.hdc, 
pPb->Rect.left, 
pPb->Rect.top, 
pPb->pSize.x, 
pPb->pSize.y, 
pPb->hDe, 

0, 0, SRCCOPY); 


Tinally, we have to clean up the device 
contexts and bitmap. The compatible de- 
vice context and bitmap are deleted, since 
we are done with them. We do not save 
these between calls because both the de- 
vice context and bitmap are very scarce 
resources and our application might not get 
painted again for awhile. For the real device 
context, we call EndPaint to free itand mark 
the window as repainted. 


DeleteDC (pPb->hDc) ; 


DeleteObject (pPb->hBm) ; 
EndPaint (pPb->hWnd, 
& (pPb->sPs) ); 
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To be continued... 


David Thielen is a senior software design 
engineer in Microsoft's MS-DOS/Windows 
Business Unit., currently working on an 
unannounced product. Prior to joining 
Microsoft, be was director of software devel- 
opment at Harris & Paulson. The opinions 
expressed in this article are those of the 
author and not necessarily (in some cases 
definitely not) those of Microsoft. 


Don't miss the concluding part of this ar- 
ticle in February’s .EXE, when David will 
explain how to overcome some subtle blt 
incompatibilities, Plus: The concluding 
part of Graeme Webster's Colour Quantisa- 
tion, xBASE goes to Windows, Laine, Jules 
et al. See you next month, 
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A unique range of goods, from 
Software to Softwear, from ‘mere’ 
Mugs to Magic Mugs, all at 
exceptionally reasonable prices and 
guaranteed to be dispatched as 


soon as your order is received. 
Look for the flashes indicating 


b DISCOUNT DISCOUNTS !! 
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SOFTWARE 


There are now a total of 16 .EXE disks to choose from. Each disk contains around 700k of 
compressed data which expands to around 1.4Mb. Many utilities from the pages of .EXE are 
included, with lots of Public Domain and shareware programs which the .EXE staff have se- 
lected from the various BBS and on-line systems available. For a complete listing of all the 


.EXE disks contents, call 0442 824501 NOW. 


£8.00 per disk. volumes 1-12, £9.00 volumes 13 onwards. 


if 
BINDERS 


Keep issues of EXE in mint condition. 
These binders - Blue or Grey - hold a 

year’s worth of .EXE (including supple- 
ments), and prevent annoying "borrowing" 
and stack failure. £8.50 
Blue - Ref: EMBB _ Grey - Ref: EMBG 


DISK HOLDERS 


Desk full of disks? Losing backups? These 
disk holders take 20 314" disks in strong, 
clear vinyl pockets. Blue or grey, with the 
-EXE logo. £9.00 


Blue - Ref: EDHB Grey - Ref: EDHG 


MOUSE MATS: poiscounr§ 


"Terminal Junkie" 


235mm by 205mm, the mats feature Chris 
Duggan’s famous Terminal Junkie cartoon, 
also featured on the ‘Addicted to C’ T-shirt. 


WERE £7.50 NOW £5.99 — Ref: GPM1 


MUGS 


‘The Original’ .EXE Mug 


A quality china mug with the so-stylish 
.EXE logo in green on a white background. 
Stand out from the run-of-the-mill office 
mugs with one of these on your desk. 


£3.50 Ref: GM3W 


HERE ITISh 
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‘The Magic Mug’ 

Developed using space-age technology and 
heat-sensitive glaze. Asking the age-old 
question "Where is that mouse cursor ?", 
the answer only becomes apparent when 
hot liquid is added. See the picture above. 


Ref: GM2W 


SOFTWEAR 


Sweatshirts: p DISCOUNTS 


Designed to complement the range of .EXE 
T-shirts, these Extra large white sweatshirts 
are available in two designs: the "Sweat- 
shirt - Software" and "Born to Compile" 
versions. Heavyweight and durable, they 
are ideal for the Great British Winter. 


WERE £14.95, NOW £10.99 
Born to Compile - Ref: UIWXL 
Sweatshirt - Software - Ref: U2WXL 


T-shirts: 


All 6 designs are available with either 
green with white printing or white with 
green printing, in sizes L & XL allowing 
plenty of choice for the discerning devel- 
oper. Choose from: 


White T3W 
White TSW 
White TEW 
White T4W 
White T8W 
White T7W 


Ashe returned to the computer room Green T3G 
.EXE logo Green T5G 
Software developers do it best Green T6G 
Verity Stob has (not) got a big bottom Green T4G 
Addicted to C Sold Out 
Registered OOP Addict Sold Out 


WERE £9.50 NOW £4.99 
Order now while stocks last 


Golf Umbrellas: 

Hate getting wet waiting for the train, or 
does your office roof leak? The .EXE golf 
umbrellas sport alternate white and green 
panels with the EXE logo in green. 


£19.95 Ref: GRGI 


Please see the order form on the back 
page to place your order. Alternatively, 
ring our order hotline with your details. 


oem ORDER HOTLINE 
ry 0442 824501 


-EXE DISKS 


Volume 13 to 16 of the ‘EXE Disks’ are now available. 


Packed full of public domain utilities and programs, many with full source code, the new .EXE Disks are 
ideal for any Windows Programmer. Each 3!" disk contains 700k of compressed files, expanding to a 
stunning 2Mb, the Disks’ contents have been selected by the editorial teams at .EXE and Basic Magazine as 
the best of the thousands of items currently available. 
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APPSHL 

Microsoft says we should use Common Dialogs. That's 
all very well, but you can't see them at design time. The 
solution? A set of ready-built Common Dialog forms 
with code to handle such chores as Opening/Saving 
files and Printer setups. (FreeWare) 


BC_CDK 

The problem with writing your own VBW custom 
controls is that (apart from the fact it's very difficult) the 
CDK documentation assumes you're using a Microsoft 
C compiler. This guide will show you how to do it using 
the Borland compiler. (Public Domain, requires CDK) 
HUGE 

Having problems cramming data into 64 KB chunks of 
memory? Here is a DLL which opens the doors to Huge 
Arrays under Visual Basic V1.0. Comes complete with 
C source and example VBW project. (Public Domain) 
MSGBOX 

Create your own unique message boxes with this 
interactive designer. Once perfected the design can be 


Ref; ED133 
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Messages Ossiayed 


copied to the Clipboard and pasted into your own VBW 
projects. (FreeWare) 


VB4CTRLS 

These four custom controls will make your applications 
stand out from the crowd. There's two thermometers, a 
spin button (like the one in VBW Professional Toolkit) 
and a 3D Label. An example project shows you how to 
use them. (FreeWare) 


VBFLIP 

An example project which will show you how to access 
the Windows GDI to create unusual animated effects 
such as bitmaps which flip over like a coin or open up 
and blossom like an Iris. Incidently, VBW V2.0 contains 
an identical demo. (Public Domain) 


VBPTR 

A question on the lips of many VBW programmers is 
that of how to cope with pointer support, especially 
pointers to functions used in API calls. This DLL 
provides routines for obtaining the address of VBW 
variables and for manipulating pointers returned from 
Windows API calls. (FreeWare) 


BROWSE 

This provides a custom control to harness the power of 
VXBASE, and presents it in a form VBW programmers 
can readily access. A sample database browser 
application is provided. (ShareWare) 


THuyer Records 
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VXBASE 

Everyone knows that database support in VBW is 
primitive. VXBASE is a DLL which gives VBW 
developers access to the xBASE .DBF files and Clipper 
-NDX indexs. It comes with extensive documentation 
and example VBW projects. (ShareWare) 
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GRID2/GRIDTEST 

This is a VB custom control for presenting data in a 
tabular format. Individual cells can be set at both design 
and run-time using the Row, Col and Text properties. 
A sample application is provided. (Public Domain) 


MULPIK 

The VB Check-Box is a static control - it isn’t suitable 
for situations when options must be added or removed 
‘on the fly’. MULPIK shows hows to write such applica- 
tions using multiple selection list boxes. (Public Domain) 


BMPKIT 

Short of directly calling routines in the Windows GDI, 
there's precious little VB can offer developers in the 
way of bitmap support. Here is a DLL which provides 
developers with a way to move, stretch or print bitmaps 
at run-time. (Public Domain) 


PROGGUIDE 

Build a VB application in no time using these pre- 
defined forms. Includes a general purpose error 
reporter (for trapping Divide By Zero etc) anda 
complete text editor with Open and Save buttons. 
(Public Domain) 


SYSWIT 

Here is a utility which lets you switch between several 
Windows SYSTEM.INI files. The program is written in 
VB and the VB project files are supplied so you can see 
how the author did it. (Public Domain) 


VBHWND 

Before the launch of VBW V2.0, the only way to obtain 
the Window handle of a VB control was to use a 
cumbersome series of SetFocus/GetFocus/ PutFocus 
methods. The VBHWND DLL provides a single function 
call which does the same thing. (FreeWare) 


VBKBASE 

The Visual Basic KnowledgeBase is a database of 
reported bugs, work-arounds and tons of example code 
which describe how to do such things as calling the 
Windows API or creating scrollable viewports. 

(Public Domain) 
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CPVB21 

Code.Print is ‘pretty-printer’ for VB projects. It takes 
.TXT source files and prints using configurable output 
styles: ie comments in italics, function declarations in 


Code.Print for Visual Basic 
file Options Help 


(oe ae 
i | | 


ib Numb 


Gick ff 


bold. The developer can choose to print an individual 
function, a module or the entire project, It will also print 
an entire project. (ShareWare) 


XTASK 

This DLL provides VB developers with a way to check 
when a shelled-out application has terminated. Each 
task to be watched must be assigned a unique Task ID 
and a handle to the Form which will respond, When the 
watched application terminates, it sends a KeyDown 
message to the specifed Form with the ID as a 
parameter. (Public Domain) 


WINDLL 

There never seems to be one definitive reference which 
details exactly how you call the hundreds of Windows 
API calls from VB. WINDLL is an online educational tool 
which gives some help to confused developers. 


‘wildest Feievence Proje 


It contains several Windows Help files and interactive 
examples which show how the specifed API call should 
be set up. (ShareWare) 


INPUT 

INPUT is a demo version of a 3D alternative to the VB 
text-box which uses the right mouse button for selecting 
properties - this is faster even than VBW V2.0's 
Property Window. (Demo) 


ee ORDER HOTLINE 
rey 0442 824501 
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MULTIP 

Here is an example program which illustrates the power 
of the Microsoft Foundation Classes (MFC). The actual 
program is a fully working programmer's editor with 
multiple windows, Print & Printer Setup dialog boxes 
and a Cut & Paste facility. Other features include 
Search & Replace, Find Next/Previous and 
Tile/Cascade for rearranging windows. The default font 
can also be altered, With over 55 KB of source, 
MULTIP provides a thorough foundation for building 
your own MFC applications, especially MDI apps. 
(Public Domain) 


PREVIEW 

Itis often necessary to determine which fonts are 
available to the system. PREVIEW is a 500-line TRW 
program which will show you how to do this using OWL. 
The code provides plenty of examples on font 
manipulation, and is an ideal starting point for writing 
applications such as Windows text editors. (Public 
Domain) 


ULTRACLIP 

The problem with the Windows 3.1 clipboard is that it 
only lets the user copy one object at a time. 
ULTRACLIP is a utility which allows you to store as 
Many objects on the clipboard as your system memory 


Pre Eu Window 


will allow. Each time an object is copied to the 
clipboard, ULTRACLIP creates a new window and 
copies the object into it. A user can then paste from this 
window into another application. Full TPW source is 
included. (Shareware) 


PROFFT 

If you've shied away from image-processing as a result 
of the near-supercomputer performance needed or 
simply the cost of the software, then look again. 
PROFFT is a Public Domain image processing package 
for Windows which gives remarkable performance using 
the Fast Fourier Transform (FFT). After a Windows 
bitmaps (.BMP) has passed through the FFT, PROFFT 
provides the user with a total of 7 filters for enhancing 
the image. Including Low pass, High pass, Band pass, 
Butterworth Low & High pass and a freehand filter. 
Complete OWL C++ source included. (Public Domain) 


MASKED EDIT 

Try this. Go into Windows Control Panel and select 
‘Ports’, then ‘Settings’. Now type in your name in the 
‘Baud Rate’ edit field. See the problem? That's a 
numeric field, yet Windows doesn't stop Snoopy from 
keying in ‘Charlie Brown’. This C++ class for OWL 
enhances the standard edit field by allowing the 
developer to specify a Filter containing characters 
which are acceptable as input. MASKED EDIT comes 
with BC++ project and source files and an example 
implementation. (Public Domain) 


TXT2RIF 

Before you can start creating your own Windows Help 
files, you've first got to buy a wordprocessor like MS 
Word for Windows which can produce Rich Text Format 
(RTF). Alternatively, you could use this DOS-based 
utility to convert a standard ASCII text-file into a RTF 
file. Special ASCII characters are embedded in the text 
file in order to specify Help features such as Titles, 
Keyword, Cross References etc. The text file can also 
reference bitmaps. TXT2RTF comes with an example 
project for BC++. (Public Domain) 


WIZUNZIP V1.1 

WIZUNZIP is a good-looking Windows-based clone of 
the popular PKUNZIP DOS utility for expanding .ZIP 
files. It comprises two windows; the first lists all files in a 
selected archive and provides essential statistics on 


each file, including filename, size, date/time etc. The 
second window is a file browser for viewing text files. It 
comes with comprehensive context-sensitive Windows 
Help and over 350 KB C source. (Public Domain) 


Visual Lib 
The Windows 3.1 GDI is rather primitive when 
compared to the graphics API in Windows NT (when it's 
finally released). Visual Library for BC++ extends the 
GDI now, It contains powerful curve and surface 
drawing functions including: Bezier, Hermit Curves, 
B-Spline, and NURBS curves and surfaces. There are 
also functions for drawing several types of graphics 
object such as Polygons, Ellipses, Spheres and 
Polyhedra. (Shareware) 
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DLLMAKER 
This is a TPW utility for assembling a set of units into a 
DLL. It takes a unit's interface section(s), and generates 
two new files: a ‘binderey unit’, which repeats all type 
declarations and implements all procedures as 
externals in the DLL, and an ‘export library’, which 
explicitly exports public procedures and object methods. 
(Shareware) 


EDI THREADS 

Threading is the mechanism by which a program can 
be made to perform several actions simultaneously - it's 
the secret of writing really responsive applications. 
Previously threads were linked with high-powered 32-bit 
operating systems such as Windows NT and OS/2, but 
EDI THREADS brings multi-threading into the world of 
Windows 3.x programming. The library is distributed as 
a DLL with BC++ and TPW interfaces. (Shareware) 


HEAP AUDITOR 

Failure to free resources is a common headache in 
Windows programming and is extremely difficult to track 
down: often the clue you have that something is wrong 


Heap Ault 


is when Windows crashes. HEAP AUDITOR is a utility 
which displays various statistics about the GDI, Global 
and Local Heaps. By checking the report before and 
after the program under examination has been run, a 
developer can determine whether memory leaks have 
occurred. (Public Domain) 


Windows Kermit 
This is a Windows-hosted terminal emulator which 
enables the user to upload and download files to/from 


it 


remote servers using the widely available Kermit file 
transfer protocol. The package includes substantial 
support for VT100 and VT52 terminals and comes with 
over 400 KB of C source which can form the basis of a 
full-blown comms package. (Public Domain) 


NNTPW 

The Novell NetWare API can easily be invoked from a 
DOS applications, but it is more difficult to access in 
Windows. NNTPW is an example program written in 
TPW from the November '92 issue of .EXE which 
illustrates how it's done. (Public Domain) 


OWLBWCC 

OWLBWCC is a group of 18 example programs (with 
full source code) for using Borland custom controls 
(BWCC) with OWL. The examples include: how to 
create a basic BWCC dialog box with metal 
background, group boxes, bumps and dips; how to use 
a large custom button as a splash screen and how to 
perform delayed processing. (Public Domain) 


IDLE 

In the December 1992 issue of .EXE Laine Stump 
described an extremely elegant way to perform 
background multi-tasking in Windows using a generic 
class derived from Microsoft Foundation Classes. IDLE 


contains the code from the article. There's over 200 KB 
of source, including Laine's MFC code for a 
thermometer custom control. If you've exhausted the 
Microsoft examples and you're looking for new material 
on MFC, then IDLE is bound to teach you many new 
tricks. (Public Domain) 


XLMATH 

This is a DLL which extends Microsoft Excel by 
providing custom functions including diagonalizing a 
real symmetric matrix, creating a frequency distribution 
and curve fitting functions. C source code is included for 
extending the DLL and the documentation looks into the 
difficulties with writing DLLs for Excel such as memory 
issues, Excel's instance handle and Excel data types. 
(Public Domain) 


UNDOCFCT 

How can you be sure that the software you're running 
will be compatible with future releases of Windows? 
Many commercial Windows applications rely on 
undocumented Windows API calls. If Microsoft alters 
these undocumented functions at a later date, such 
software may not function correctly. UNDOCFCT is a 
utility which provides an early warning of potential 
incompatibility by printing all undocumented entry points 
and external references in a Windows executable. 
(Shareware) 


If you would like to order some 
.EXE Disks, please refer to the 
order form on the back page. 
Please remember to put the 
relevant reference numbers on 
the form. 


Our price is £9 per 31" disk. 
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Dear EX- .EXE Reader 
WE MISS YOU 


Welcome to 1993, a year guaranteed to see .EXE bigger and better than ever before. You will already have seen the article 
inside on Windows development, which continues our commitment to the coverage of leading edge development topics. 


This year we will be covering subjects like xBASE, Object Orientation, Databases, Windows, Networking and 
Communications, Multimedia, Security, Operating Systems, 4GLs and Application Generators, C & C++ programming, 
and Software Engineering (to name but a few). 


As a valued ex-reader, we do not want you to miss out on any of this, so we feel compelled to make you this offer. 
Subscribe to .EXE now for two years and.... 

@ Receive a FREE .EXE disk, worth £9.00. 

@ Receive a FREE .EXE disk holder worth £9.00. 

@ Save 20% on your subscription. 


A subscription to EXE costs £56 for two years (£80 European) or £35 for one year (£50 European). 


So, if you have not received .EXE for a while, or your subscription has lapsed, take advantage of this offer now by 
completing the form below. 


Yours sincerely, 


eae 


Ed Butcher 
Circulation Manager 


I want to subscribe to .EXE for two years at the reduced rate of £56. I understand that I will receive a FREE .EXE disk, 
a FREE disk holder. 
I would like .EXE Disk Volume 13 14 15 16 (please circle your preference - refer to contents list on pages 6 & 7.) 


I want to subscribe to .EXE for one year at the normal rate of £35. 
I WOULD LIKE TO ORDER THE FOLLOWING GOODS (see the EXE Directory p5 of this brochure, p6 & 7 for disks) 


DESCRIPTION REFERENCE NO. QUANTITY UNIT PRICE TOTAL PRICE 


Please add P&P £1.50 for goods up to £10 - £2.50 for over £10 (excluding subscription price) 


SUB TOTAL PRICE — 


Add subscription price (£56 2 yrs, £35 tyr, £50 tyr European) TOTAL > 


Name: 
Job Title: . 
AGGreSS! .sssssissciesosssorssssetvanssosennenes 


I enclose a cheque for £ (Drawn on a UK Bank - made payable to Process Communications Ltd) 


Please send this form to: 
Process Communications Ltd, FREEPOST, 90 Miswell Lane Tring, Herts HP23 4EB or telephone your order through on 0442 824501. 
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